home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / rdsh_11.zoo / rdsh.doc < prev    next >
Text File  |  1992-04-30  |  6KB  |  109 lines
  1.         RDSH  -  A Mini-Shell to complement the RDY/RDE Ramdisk
  2.  
  3.           RDSH.PRG  is a mini-shell,  tailored to the  quick  command line 
  4. invocation  of RDY/RDE from the desktop.   Clearly it is wasteful of  time 
  5. to enter an elaborate shell like Mark Williams Co's MSH.TOS (or GULAM)  if 
  6. all we wish to do is load a ramdisk - the ensuing warm-reset would  render 
  7. all  the rehashing normally done on shell-entry a complete waste of  time. 
  8. This  is a quick-loading (it does not hash - though it uses a  PATH)  very 
  9. tiny  shell that compiles to about 9  kbytes (and  is less than  6  kbytes 
  10. when  "packed" with the PACK-ICE packer) - so that it becomes feasible  to 
  11. have multiple copies of it  in  all  work directories on one's hard  disk. 
  12. This mini-shell has some unique features viz.
  13.  
  14.            Option "U" will update (i.e.  touch edit) old  "saved"  RDY/RDE 
  15. ramdisk  files  so that they become of the  "All-TOS"   variety.  This  is  
  16. achieved   virtually  instantaneously  -  invaluable  to  those  who   are  
  17. "upgrading" and have many "old" RDY saved installation files.
  18.  
  19.            Option  "A" will alter the drive label of a saved ramdisk  file 
  20. by touch editing (also virtually  instantaneously).  I,  personally,  have  
  21. long felt the need for this!  - as there are many occasions when I  wished  
  22. to load two ramdisks simultaneously that happened to have been saved  with 
  23. the same volume_ (or drive)_letter.   Also,   when I aquired  a hard  disk 
  24. (100 Mbytes), I found that drive_labels C,D,E,F had to be   made available 
  25. to  the  latter - and so I had (then)  to  laboriously  convert   my   RDY 
  26. installations  that  used these labels by  loading their contents   to   a  
  27. freshly   made  (empty) ramdisk  (with  the   new   desired  drive_label).  
  28. With    this  option  the  conversion  would  have  been  a  5  sec   job!           
  29. Options "S",  "M", "D", "L" and "E" enable quick & economical Command Line 
  30. invocation  of the usual Save,  Make,  Drop,  List and Load (or  Execute).  
  31. RDSH   does  this by searching a PATH for RDE/RDY (endings can   be  .TTP   or 
  32. .PRG) - its default "built-in"  PATH  can  be   over-rided   if  it  finds  
  33. an  alternative  PATH defined in a file "RDSH.PTH" (which it searches  for 
  34. in  $cwd,  then in Root_directory  of the current drive  and   lastly   in  
  35. C:\)   Additionally  RDSH  can execute other programs found in  the   same 
  36. PATH intelligently i.e.  if it finds .PRG in the executable's filename  it 
  37. executes  it  under GEM (clears screen,    provides   background    "grey"  
  38. with  LINEA,    activates  mouse,   disables  text-cursor  etc.) else   it  
  39. executes   things   under   TOS.    Further (and  I   "think"   this    is  
  40. novel)    -   when   RDSH  "finds"  its  target  "PROGRAM.PRG"   in   some 
  41. directory   of  the PATH it will "look" to see if there is  a   "resource" 
  42. file,  "PROGRAM.RS?" in the same directory,  and, if so, will then "pushd"  
  43. to  that  directory  before  GEM-executing  the program.   Of course,   it 
  44. will "popd" back when the child process terminates. Thus the command
  45.  
  46.                          E    DEGELITE.PRG
  47.  
  48. would   execute (say) "DEGELITE.PRG" in a remote directory and  find   its 
  49. resources etc.  and  E RDE.PRG   would do likewise (except the whole point 
  50. of  RDSH is to avoid this to gain the extra flexibility of  command   line 
  51. invocation - and,   of course,   it also would not work because RDY  would 
  52. "assume"   command line invocation as RDSH has set the   CMD   environment 
  53. variable!).   It can be advantageous sometimes to make a "dummy"  PROG.RS? 
  54. file in the remote directory,   even though the program uses no   resource 
  55. files, purely in order to "pushd" to the remote directory.
  56.  
  57.           RDSH  can  also  do  other  small  tasks  like  filecopying 
  58. ("C"),  renaming ("N"), deletion ("R"), Warmreset ("W"), Coldreset ("C") 
  59. and  if invoked with no arguments will give a reminder (description)  of 
  60. its commands an the screen (as shown below).
  61.  
  62.           As can be seen, its features are virtually self-explanatory.
  63.  
  64.  
  65.   **************************************************************************
  66.   *     RDSH - MINI SHELL for Mark Williams Co.'s RDY/RDE RAMDISK Utility  *
  67.   *     PATH may be DEFINED BY "RDSH.PTH" searched for in .,ROOTDIR:,C:   *
  68.   *    [ DEFAULT PATH = ,O:,C:,C:\BIN,D:,E:,F:,C:\TOOLS,E:\PUBLISH,       *
  69.   *  D:\SIGNUM,D:\DEGAS,C:\WORDPLUS,A:,A:\AUTO, ] for  RDE & EXECUTABLES   *
  70.   *        [ W. Alan B. Evans    <wabe@ukc.ac.uk> Nov 1991 ]       *
  71.   **************************************************************************
  72.  
  73.   USAGE:
  74.  
  75.   rdsh (Q)uit;                    rdsh (H)elp 
  76.   rdsh (W)arm Reset                rdsh (X)Cold Reset 
  77.   rdsh (P)ATH - shows CURRENT PATH in use    rdsh (V)olumes(Drives) List 
  78.   rdsh (E)xecute [prog_name] <arguments>    rdsh (C)opy [file1] [file2] 
  79.   rdsh (D)rop [DISK]                rdsh (R)emove [file(s)] 
  80.   rdsh (N)ame [Old_File_name] [New_File_name] 
  81.   rdsh (M)ake [DISK] [SIZE] <BOOT=1{0}> <FILE=file_name{"rd(y/e)disk.prg"}> 
  82.   rdsh (L)ist <DISK=disk_label{all disks} or FILE=file_name> 
  83.   rdsh (S)ave [DISK] <file_name{"rd(y/e)disk.prg"}> 
  84.   rdsh (A)lter drive_label of saved ram_disk_file [FILENAME] [NEW_DRIVE_LABEL] 
  85.   rdsh (U)pdate old RDY/RDE Ramdisk_Files to "ALL-TOS" [RAMDISK_FILENAME{S}] 
  86.  
  87.     Nb:    DEFAULTS are in {...} 
  88.  
  89.   RDSH COMMAND: u  d:\sign_ram.prg
  90.   RDSH COMMAND: a  d:\sign_ram.prg    i
  91.   RDSH COMMAND: m  g 709 FSIZE=5 FATSIZE=12
  92.  
  93.  
  94.         Note the first command shown entered would update an old saved RDY 
  95. file called SIGN_RAM.PRG on D:\ to the "All-Tos" Format. For this to work, 
  96. it is ESSENTIAL that such files have NOT been "packed" (with PFXPAK or the 
  97. like). The next command changes the Volume Label of the stored File to I:\ 
  98. from  whatever  it was initially - a message will  inform  you.  The  last 
  99. command makes a ramdisk G:\ with a (default) "floppy" FAT structure i.e. 5 
  100. sectors  per FAT with 12-bit FAT entries.  Such a disk's contents  can  be 
  101. quickly  transferred to Floppy (or vici-versa) using a sector copier  like 
  102. DFT.PRG (part of DFSUITE2 - available from Atari Archive).
  103.            
  104.                               W. Alan B. Evans, [wabe@ukc.ac.uk]
  105.                               Physics Laboratory,
  106.                               University of Kent,
  107.                               Canterbury,
  108.                               Kent, CT2 7NR, U.K.
  109.